MultiEdit Box Tool
A MultiEdit Box object is a field for multiple-line user input (for single-line input, use an Edit Box). A MultiEdit Box functions similar to an Edit box, but it includes additional methods for accessing specific lines within the text. Both horizontal and vertical scroll bars can be used to scroll through the box.
A MultiEdit Box can also be used to display text. If desired, you can set the object’s ReadOnly property to 1 - Yes to prohibit editing.
Using the object’s CaseOrPassword property, the text can be converted to all lowercase, all uppercase, or password masked (displayed as asterisks). Any checks for text type (valid characters) or valid data ranges must be scripted.
Script is required for an action to occur when using a MultiEdit Box object. See Scripting in CygNet Studio for examples.
The HorizontalScroll and VerticalScroll properties have three possible values: None, Always, and Automatic. They do not mean what you probably assume they mean.
| Option | Description |
|---|---|
|
0 - None |
Do not display scroll bars, and do not allow text to exceed window boundaries. The HorizontalScroll property adds the word “(WordWrap)” next to the option. In the case of VerticalScroll, it means that there is a lower limit to the text you can add. You can add larger amounts of text via script, but you will be unable to view any text below the bottom of the window. |
|
1 - Always |
Always display scroll bars. |
|
2 - Automatic |
This option does not strictly apply to scroll bars. It means “automatically scroll.” Whereas None puts strict boundaries on the edit window, with this option you can keep entering text, and the window will automatically scroll to display that text, but there will be no scroll bars ever displayed. You can still navigate the entire body of text with arrow keys, selection, etc. |
More:
